home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Format CD 41
/
Amiga Format CD41 (1999-06)(Future Publishing)(GB)[!][issue 1999-07].iso
/
-seriously_amiga-
/
cd-rom
/
acdb
/
acdb_pl.readme
< prev
next >
Wrap
Text File
|
1999-04-28
|
9KB
|
237 lines
ACDB v1.1 (19.04.99)
FREEWARE
©1999, Piotr Gapiïski <narg@polbox.com>
[ADNOTACJE]
WERSJA BETA DO TESTOWANIA!
AUTOR NIE PONOSI ODPOWIEDZIALNOÔCI ZA EWENTUALNE STRATY SPOWODOWANE
UÛYTKOWANIEM PROGRAMU!
[PROGRAM]
acdb (amiga cd [data] base) to program umoûliwiajâcy zaimportowanie opisów pîyt
kompaktowych cd-da (audio) z internetowej bazy danych i zapisanie na dysku lokalnym
w formacie zgodnym ze SCDP (format rozpoznawany przez wiëkszoôê amigowych
cd-playerów).
[WYMAGANIA]
1. komputer AMIGA, OSv37+ (2.04+)
2. TCP/IP (bsdsocket.library v4+)
3. reqtools.library v38+
4. easyrexx.library v3+
biblioteka ta moûe byê rozpowszechniana na zasadach public-domain,
prawa autorskie naleûâ do ©1996 Ketil Hunn
[ZMIANY]
acdb 1.1 (19.04.99)
1. progress indicator dziaîa takûe przy ôciâganiu opisów komendâ Arexx'a DOWNLOAD IDFILE
2. po zakoïczeniu procesu pobierania opisów wyôwietlane jest podsumowanie
(iloôê plików w katalogu TEMP, iloôê plików przeszukanych w CDDB, iloôê plików znalezionych
w CDDB)
3. jeûeli CLEANTEMP=no to po poprawnym ôciâgniëciu opisów plik z katalogu TEMP bëdzie
miaî zmienionâ nazwë przez dodanie sufiksu .ok
[URUCHOMIENIE]
Program moûna uruchamiaê zarówno z poziomu CLI jak i WORKBENCH'a z tym, ûe w tym
drugim przypadku moûliwe jest przekazanie przez TOOLTYPE ikonki dodatkowych
parametrów.
Workbench:
DEVICE=<device name>
nazwa sterownika napëdu CD-ROM, domyôlnie cd.device
UNIT=<number>
numer urzâdzenia jako które jest podîâczony CD-ROM, domyôlnie 0
HOST=<cddb host>
adres internetowego serwera cddb, domyôlnie www.cddb.com
listë serwerów moûna pobraê z internetu dziëki programowi acdb_hosts
znajdujâcego sië w archiwum z programem
PORT=<cddb port>
port przez który bëdzie nawiâzana komunikacja z serwerem cddb, domyôlnie 80
CDTIME=<yes|NO>
decyduje o umieszczaniu o opisach pîyt pobranych z internetu caîkowitego
czasu trwania pîyty, domyôlnie NO (nie)
TRACKTIME=<yes|NO>
decyduje o umieszczaniu o opisach pîyt pobranych z internetu czasów trwania
poszczególnych utworów, domyôlnie NO (nie)
CLEANTEMP=<YES|no>
decyduje czy pliki tymczasowe (zapisywane w katalogu TEMP) majâ byê, po
pomyôlnym pobraniu opisów z internetu, kasowane czy teû nie, domyôlnie YES (tak)
przy opcji 'no', pliki dla których poprawnie ôciâgniëto opisy z internetu bëdâ
miaîy zmienionâ nazwë na IDxxxxxxxx.ok
DISKS=<dir>
katalog do którego bëdâ zapisywane pobrane z internetu opisy pîyt kompaktowych,
domyôlnie PROGDIR:disks
TEMP=<dir>
katalog do którego bëdâ zapisywane wszystkie pliki tymczasowe potrzebne do
prawidîowego funkcjonowania programu, domyôlnie PROGDIR:temp
ICON=<file without .info>
nazwa pliku (bez rozszerzenia .info), który bëdzie uûywany gdy program
bëdzie zikonifikowany, domyôlnie bëdzie uûywana ikonka programu lub,
w przypadku uruchomienia z poziomu CLI, PROGDIR:acdb
PUBSCREEN=<pub screen name>
nazwa ekranu publicznego na którym program ma sië uruchomiê,
domyôlnie ekran workbench'a
CLI:
Uruchomienie programu z poziomu CLI spowoduje przyjëcie przez program
paramterów domyôlnych (nie ma moûliwoôci ich zmiany).
[PROGRAM]
Program umoûliwia (prawie) automatyczne pobieranie opisów pîyt audio z
internetowej bazy danych CDDB. Tok postëpowania jest nastëpujâcy:
1. przygotowanie identyfikatorów pîyt, których opisy naleûy
z internetu pobraê (OFFLINE)
2. pobranie opisów wczeôniej przygotowanych pîyt (ONLINE)
PRZYGOTOWANIE IDENTYFIKATORÓW
Dla kaûdej pîyty program tworzy specjalny plik zawierajâcy wszystkie dane
niezbëdne do pobierania opisów. Pliki te tworzy sië przez naciôniëcie
przycisku 'WriteID' - program sprawdza czy opis dla danej pîyty nie jest juû
pobrany (sprawdza w katalogu DISKS) i jeûeli nie to zapisuje dane w katalogu
TEMP.
POBRANIE OPISÓW
Po naciônieciu przycisku 'Download' program bëdzie sië staraî pobraê
wszystkie opisy pîyt dla których przygotowano pliki identyfikacyjne.
Moûe sië zdarzyê, ûe identyfikator pîyty nie jest jednoznaczy tzn. jeden
identyfikator okreôla kilka pîyt w bazie CDDB - wtedy program pobierze
WSZYSTKIE pasujâce opisy i zapisze z przyrostkiem okreôlajâcym numer kopii
(np. IDxxxxxxxx.1).
Jeûeli z jakichkolwiek przyczyn nie byîo moûliwe pobranie opisów, program
albo przerwie dziaîanie sygnalizujâc to odpowiednim komunikatem albo
przez dodanie przyrostka zmieni nazë pliku CDID (z tatalogu TEMP) na
nazwë opisujâcâ bîâd (np. IDxxxxxxxxx.corrupt czy .not found).
Pliki takie sâ przez program pomijane przy pobieraniu opisów.
Po pobraniu wszystkich moûliwych opisów dla danego identyfikatora pîyty
odpowiedni plik z katalogu TEMP zostaje skasowany (zobacz tez
TOOLTYPE/CLEANTEMP).
Podczas pobierania opisów program wyôwietla informacje o stopniu
zaawansowania procesu umoûliwiajâc takûe przerwanie operacji (Abort).
[PORT AREXX'A]
Program posiada port Arexx'a o nazwie ACDB[.X], gdzie .X jest opcjonalnym
numerem kopii programu (ACDB, ACDB.1, ACDB.2, itp.)
Jak na razie dostëpne sâ komendy:
QUIT
koïczy dziaîanie programu
TRAY OUT
TRAY IN
komenda obsîugujâca podajnik (tray) napëdu CD umoûliwiajâc jej wysuniëcie
(OUT) bâdú teû schowanie (IN).
CDID FORCE STORE
CDID STORE
CDID DOWNLOAD
obsîuga plików CDID dziëki której plik identyfikujâcy pîytë moûna zapisaê
do katalogu TEMP (STORE) lub teû od razu pobraê z internetu opis pîyty
znajdujâcej sië w napëdzie CDROM (DOWNLOAD);
podczas zapisywania pliku program sprawdza czy dla pîyty o takim
identyfikatorze juû istnieje opis (w katalogu DISKS) - jeûeli istnieje
to zostanie wyôwietlony requester z prosbâ o potwierdzenie operacji;
uûycie parametru (FORCE) powoduje natychmiastowy zapis pliku bez
wczeôniejszego testowania
DOWNLOAD CDID
DOWNLOAD ALL
wymusza poîâczenie z internetowâ bazâ CDDB i pobranie opisu pîytki
okreôlonej przez nazwë pliku identyfikacyjnego (z katalogu TEMP)
lub teû wszystkich pîyt dla których w katalogu TEMP przygotowano pliki (ALL);
UWAGA! przy podawaniu nazwy pliku naleûy pamiëtaê o ôcieûce dostëpu
GET COMMANDLIST
GET AUTHOR
GET COPYRIGHT
GET VERSION
GET LASTERROR
zwraca listë wszystkich komend (COMMANDLIST), które program rozpoznaje,
identyfikator autora programu (AUTHOR), informacje na temat praw autorskich do
programu (COPYRIGHT), informacje na temat wersji programu (VERSION), informacje
o wykrytym ostatnio bîëdzie w przetwarzaniu komend Arexx'a (LASTERROR)
przykîad:
/* test
*/
OPTIONS RESULTS
ADDRESS ACDB
CDID DOWNLOAD
IF (result = 0) THEN DO
GET LASTERROR
SAY result
END
[TIPSY]
1. Program zapisuje poîoûenie i wymiary gîównego okienka do pliku
ENV:acdb
moûna wiëc plik ten przekopiowaê do katalogu ENVARC: a zawarte w nim
ustawienia bëdâ ustawieniami domyôlnymi programu
2. Jeûeli podczas deikonifikacji program nie wykryje ekranu publicznego na
którym uprzednio byî uruchomiony, to do czasu ponownego pojawienia
sië ûâdanego ekranu bëdzie korzystaî z domyôlnego ekranu publicznego
systemu (najczëôciej jest to ekran workbench'a)
3. Jeûeli program jest uruchomiony z CLI to naciôniëcie klawiszy
CTRL-C spowoduje zakoïczenie dziaîania programu, CTRL-F spowoduje
deikonifikacje a CTRL-D przerwanie pobierania danych z internetu
[ZNANE BÎËDY]
Do tej chwili (acdb, v1.1, 19.04.99) zostaîy wykryte nastëpujâce bîëdy:
1. opisy pîytek nie zawierajâ polskich znaków (i raczej nie bëdâ ich zawieraîy)
to raczej nie jest bîâd - po prostu serwery CDDB obsîugujâ tylko kod Latin-1
2. testowanie naciôniëcia przycisku Abort nastëpuje tylko w przerwach
miëdzy odbiorem poszczególnych paczek danych z internetu (100 bajtowych)
wiëc nie zawsze naciôniëcie przycisku da natychmiastowy efekt
3. jeûeli program jest zikonifikowany to nie bëdzie dziaîaî port Arexx'a
[KONTAKT Z AUTOREM]
Wszelkie raporty o bîëdach, sugestie i komentarze proszë przesyîaê na adres:
narg@polbox.com
http://free.polbox.pl/n/narg
[PODZIËKOWANIA]
Wielkie dziëki dla beta-testerów:
* Artur Bychowski <jobo@zt.suwalki.tpsa.pl>
* Michaî Durys <misha@femina.com.pl>
* Piotr Pawîow <pp@union.org.pl>
* Roman Dobosz <gryf@elysium.pl>
[TECHNICZNE INFORMACJE]
Program powstaî w jëzyku AmigaE i uûywa nastëpujâcych moduîów:
1. EASYGUI, © Wouter, Jason
2. ICONIFY PLUGIN, © Piotr Gapinski
3. AFC/PARSE, © Fabio Rotondo
4. FILE, © Wouter
Podczas pisania programu byîy wykorzystywane nastëpujâce materiaîy:
1. @(#)cddb.howto 1.27 (98/12/09)
2. (SCSI) X3T9.2 WORKING DRAFT (7-SEP-93)
3. RFC-1945 (HTTP1.0)
4. amiTCP/IP HTTP/GET example
5. BGUI BGPlayer example